//=============================================================================
// System  : MatchKit
// File    : TypeMappingHandler.cs
// Author  : Fabio Bussu  (matchkit@fabiobussu.it)
// Updated : 04/16/2013
// Note    : Copyright 2013, Fabio Bussu, All rights reserved
//
// This code is published under the Microsoft Public License (Ms-PL). A copy
// of the license should be distributed with the code.  It can also be found
// at the project website: http://matchkit.codeplex.com. This notice, the
// author's name, and all copyright notices must remain intact in all
// applications, documentation, and source files.
//
// Version     Date     Who  Comments
// ============================================================================
// 1.0.0.0  04/16/2013   FB  First draft
//=============================================================================
using System;

namespace MatchKit.ObjectMapping
{
	/// <summary>
	/// Encapsulates a method that dynamically manage the creation of a pattern for specific type.
	/// </summary>
	/// <param name="type">Type to create the pattern.</param>
	/// <param name="value">Value of the member. See remarks section.</param>
	/// <param name="isArray">Value specifying whether the member is an array.</param>
	/// <returns>The created pattern to match.</returns>
	/// <remarks>
	/// The <paramref name="value"/> of the matchable member is the default value of the Type declared. 
	/// So it is null for reference types, 0 for numeric values e so on.
	/// If the member is marked with 
	/// <see cref="P:MatchKit.ObjectMapping.MatchableMemberAttribute.IsDynamic"/> 
	/// the value of the member is the value found at the moment of the match.
	/// </remarks>
	/// <seealso cref="T:DefaultTypeMappings"/>
	/// <conceptualLink target="7e345cd8-bbcc-4616-a3c9-abcc9943dabc" />
	/// <conceptualLink target="0a06b2a9-5f58-409a-ba62-639cfd77bca7" />
	public delegate IPattern TypeMappingHandler(Type type, object value, bool isArray);
}
